TED External Transfer

A TED transfer is very similar to a Pix transfer with bank account details, but it uses a different system and will only be processed on business days until 17:00 BRT time

Request

URL

POST 'https://apisandbox.delbank.com.br/baas/api/v2/transfers/ted

cURL

curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/transfers/ted' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--header 'IdempotencyKey: {{guid}}' \
--data '{
  "amount": 0.01,
  "description": "test",
  "beneficiary": {
    "participantIspb": "00000000",
    "branch": "0001",
    "holder": {
      "document": "12345678901",
      "email": "[email protected]",
      "name": "Teste da Silva"
    },
    "number": "210001953"
  }
}'

Headers

Name	Description
x-delbank-api-key	Required. API key
x-delfinance-account-id	Required. The Delfinance bank account number
IdempotencyKey	Required. Request's idempotency key. Provide a GUID, being a new one for each request..

Body

Name	Type	Description
amount	number	Required. Transfer amount.
description	string	Description about the transfer, internal use only
beneficiary	object	Required. Object containing information on the transaction beneficiary
participantIspb	string	Required. ISPB code of the beneficiary client bank account.
branch	string	Required. Beneficiary account branch
number	string	Required. The account number
holder	object	Required. Object containing information about the beneficiary account holder
document	string	Required. Beneficiary account holder CPF or CNPJ
email	string	Required. Beneficiary account holder e-mail
name	string	Required. Beneficiary account holder full name

Response

The status code 200 will indicate success in the transaction.

Being successful, the return will bring the following fields in JSON format:

Note

🚧 This information will be returned after the transfer creation and transfer query.

{
    "id": "{id}",
    "status": "DONE",
    "type": "TED",
    "amount": 0.01,
    "createdAt": "2025-02-10T12:48:20.695Z",
    "description": "Test",
    "payer": {
        "number": "{payer_account_number}",
        "branch": "{branch}",
        "type": "{type}",
        "holder": {
            "document": "{document}",
            "name": "{name}",
            "type": "{type}"
        },
        "participant": {
            "name": "{bank}",
            "ispb": "{ispb}"
        }
    },
    "beneficiary": {
        "number": "{account_number}",
        "branch": "{branch}",
        "type": "{type}",
        "holder": {
            "document": "{document}",
            "name": "{name}",
            "type": "{type}"
        },
        "participant": {
            "name": "{bank}",
            "ispb": "{ispb}"
        }
    }
}